Azure IoT Central (stable:2022-05-31)

2025/10/23 • 67 new methods

ApiTokens_List (new)
Description :  Get the list of API tokens in an application. The token value will never be returned for security reasons.
Reference :  Link ¶

⚼ Request

GET:  /apiTokens
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of API tokens. ,
Required: True ,
}
[
{
id:
{
Description: Unique ID of the API token. ,
Required: False ,
}
string ,
token:
{
Description: Value of the API token. ,
Required: False ,
}
string ,
expiry:
{
Description: String-formatted date representing the time when the token expires. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of API tokens. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
ApiTokens_Get (new)
Description :  Get an API token by ID.
Reference :  Link ¶

⚼ Request

GET:  /apiTokens/{tokenId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
tokenId:
{
Description: Unique ID for the API token. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the API token. ,
Required: False ,
}
string ,
token:
{
Description: Value of the API token. ,
Required: False ,
}
string ,
expiry:
{
Description: String-formatted date representing the time when the token expires. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
ApiTokens_Create (new)
Description :  Create a new API token in the application to use in the IoT Central public API. The token value will be returned in the response, and won't be returned again in subsequent requests.
Reference :  Link ¶

⚼ Request

PUT:  /apiTokens/{tokenId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
tokenId:
{
Description: Unique ID for the API token. ,
Required: True ,
}
string ,
body:
{
Description: API token body. ,
Required: True ,
}
{
id:
{
Description: Unique ID of the API token. ,
Required: False ,
}
string ,
token:
{
Description: Value of the API token. ,
Required: False ,
}
string ,
expiry:
{
Description: String-formatted date representing the time when the token expires. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the API token. ,
Required: False ,
}
string ,
token:
{
Description: Value of the API token. ,
Required: False ,
}
string ,
expiry:
{
Description: String-formatted date representing the time when the token expires. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
ApiTokens_Remove (new)
Description :  Delete an API token.
Reference :  Link ¶

⚼ Request

DELETE:  /apiTokens/{tokenId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
tokenId:
{
Description: Unique ID for the API token. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceGroups_List (new)
Description :  Get the list of device groups in an application.
Reference :  Link ¶

⚼ Request

GET:  /deviceGroups
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of device groups. ,
Required: True ,
}
[
{
id:
{
Description: Unique ID of the device group. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device group. ,
Required: True ,
}
string ,
filter:
{
Description: Query defining which devices should be in this group, [Query Language Reference](https://aka.ms/iotcquery). ,
Required: True ,
}
string ,
description:
{
Description: Short summary of device group. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device group updates. ,
Required: False ,
}
string ,
organizations:
{
Description: List of organization IDs of the device group, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
nextLink:
{
Description: URL to get the next page of device groups. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceGroups_Get (new)
Description :  Get the device group by ID.
Reference :  Link ¶

⚼ Request

GET:  /deviceGroups/{deviceGroupId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceGroupId:
{
Description: Unique ID for the device group. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the device group. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device group. ,
Required: True ,
}
string ,
filter:
{
Description: Query defining which devices should be in this group, [Query Language Reference](https://aka.ms/iotcquery). ,
Required: True ,
}
string ,
description:
{
Description: Short summary of device group. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device group updates. ,
Required: False ,
}
string ,
organizations:
{
Description: List of organization IDs of the device group, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceGroups_Create (new)
Description :  Create or update a device group.
Reference :  Link ¶

⚼ Request

PUT:  /deviceGroups/{deviceGroupId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceGroupId:
{
Description: Unique ID for the device group. ,
Required: True ,
}
string ,
body:
{
Description: Device group body. ,
Required: True ,
}
{
id:
{
Description: Unique ID of the device group. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device group. ,
Required: True ,
}
string ,
filter:
{
Description: Query defining which devices should be in this group, [Query Language Reference](https://aka.ms/iotcquery). ,
Required: True ,
}
string ,
description:
{
Description: Short summary of device group. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device group updates. ,
Required: False ,
}
string ,
organizations:
{
Description: List of organization IDs of the device group, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}
,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the device group. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device group. ,
Required: True ,
}
string ,
filter:
{
Description: Query defining which devices should be in this group, [Query Language Reference](https://aka.ms/iotcquery). ,
Required: True ,
}
string ,
description:
{
Description: Short summary of device group. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device group updates. ,
Required: False ,
}
string ,
organizations:
{
Description: List of organization IDs of the device group, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceGroups_Update (new)
Description :  Update an existing device group by ID.
Reference :  Link ¶

⚼ Request

PATCH:  /deviceGroups/{deviceGroupId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceGroupId:
{
Description: Unique ID for the device group. ,
Required: True ,
}
string ,
body:
{
Description: Device group patch body. ,
Required: True ,
}
object ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the device group. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device group. ,
Required: True ,
}
string ,
filter:
{
Description: Query defining which devices should be in this group, [Query Language Reference](https://aka.ms/iotcquery). ,
Required: True ,
}
string ,
description:
{
Description: Short summary of device group. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device group updates. ,
Required: False ,
}
string ,
organizations:
{
Description: List of organization IDs of the device group, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceGroups_Remove (new)
Description :  Delete a device group.
Reference :  Link ¶

⚼ Request

DELETE:  /deviceGroups/{deviceGroupId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceGroupId:
{
Description: Unique ID for the device group. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceTemplates_List (new)
Description :  Get the list of device templates in an application.
Reference :  Link ¶

⚼ Request

GET:  /deviceTemplates
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of device templates. ,
Required: True ,
}
[
{
@id:
{
Description: Unique ID of the device template. ,
Required: False ,
}
string ,
@type:
{
Description: The JSON-LD types of this device template. ,
Required: True ,
}
[
string ,
]
,
etag:
{
Description: ETag used to prevent conflict in device template updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device template. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the device template. ,
Required: False ,
}
string ,
capabilityModel:
{
Description: The capability model utilized by this device template. ,
Required: True ,
}
object ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of device templates. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceTemplates_Get (new)
Description :  Get a device template by ID
Reference :  Link ¶

⚼ Request

GET:  /deviceTemplates/{deviceTemplateId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceTemplateId:
{
Description: Unique [Digital Twin Model Identifier](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/dtdlv2.md#digital-twin-model-identifier) of the device template. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
@id:
{
Description: Unique ID of the device template. ,
Required: False ,
}
string ,
@type:
{
Description: The JSON-LD types of this device template. ,
Required: True ,
}
[
string ,
]
,
etag:
{
Description: ETag used to prevent conflict in device template updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device template. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the device template. ,
Required: False ,
}
string ,
capabilityModel:
{
Description: The capability model utilized by this device template. ,
Required: True ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceTemplates_Create (new)
Description :  Publish a new device template. Default views will be automatically generated for new device templates created this way.
Reference :  Link ¶

⚼ Request

PUT:  /deviceTemplates/{deviceTemplateId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceTemplateId:
{
Description: Unique [Digital Twin Model Identifier](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/dtdlv2.md#digital-twin-model-identifier) of the device template. ,
Required: True ,
}
string ,
body:
{
Description: Device template body. ,
Required: True ,
}
{
@id:
{
Description: Unique ID of the device template. ,
Required: False ,
}
string ,
@type:
{
Description: The JSON-LD types of this device template. ,
Required: True ,
}
[
string ,
]
,
etag:
{
Description: ETag used to prevent conflict in device template updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device template. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the device template. ,
Required: False ,
}
string ,
capabilityModel:
{
Description: The capability model utilized by this device template. ,
Required: True ,
}
object ,
}
,
}

⚐ Response (200)

{
@id:
{
Description: Unique ID of the device template. ,
Required: False ,
}
string ,
@type:
{
Description: The JSON-LD types of this device template. ,
Required: True ,
}
[
string ,
]
,
etag:
{
Description: ETag used to prevent conflict in device template updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device template. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the device template. ,
Required: False ,
}
string ,
capabilityModel:
{
Description: The capability model utilized by this device template. ,
Required: True ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceTemplates_Update (new)
Description :  Update the cloud properties and overrides of an existing device template via patch.
Reference :  Link ¶

⚼ Request

PATCH:  /deviceTemplates/{deviceTemplateId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceTemplateId:
{
Description: Unique [Digital Twin Model Identifier](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/dtdlv2.md#digital-twin-model-identifier) of the device template. ,
Required: True ,
}
string ,
body:
{
Description: Device template patch body. ,
Required: True ,
}
object ,
}

⚐ Response (200)

{
@id:
{
Description: Unique ID of the device template. ,
Required: False ,
}
string ,
@type:
{
Description: The JSON-LD types of this device template. ,
Required: True ,
}
[
string ,
]
,
etag:
{
Description: ETag used to prevent conflict in device template updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device template. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the device template. ,
Required: False ,
}
string ,
capabilityModel:
{
Description: The capability model utilized by this device template. ,
Required: True ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
DeviceTemplates_Remove (new)
Description :  Delete an existing device template by device ID.
Reference :  Link ¶

⚼ Request

DELETE:  /deviceTemplates/{deviceTemplateId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceTemplateId:
{
Description: Unique [Digital Twin Model Identifier](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/dtdlv2.md#digital-twin-model-identifier) of the device template. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_List (new)
Description :  Get the list of devices in an application.
Reference :  Link ¶

⚼ Request

GET:  /devices
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of devices. ,
Required: True ,
}
[
{
id:
{
Description: Unique ID of the device. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device. ,
Required: False ,
}
string ,
template:
{
Description: The device template definition for the device. ,
Required: False ,
}
string ,
enabled:
{
Description: Whether the device connection to IoT Central has been enabled. ,
Required: False ,
}
boolean ,
provisioned:
{
Description: Whether resources have been allocated for the device. ,
Required: False ,
}
boolean ,
simulated:
{
Description: Whether the device is simulated. ,
Required: False ,
}
boolean ,
organizations:
{
Description: List of organization IDs that the device is a part of, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
nextLink:
{
Description: URL to get the next page of devices. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_Get (new)
Description :  Get details about an existing device by device ID.
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the device. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device. ,
Required: False ,
}
string ,
template:
{
Description: The device template definition for the device. ,
Required: False ,
}
string ,
enabled:
{
Description: Whether the device connection to IoT Central has been enabled. ,
Required: False ,
}
boolean ,
provisioned:
{
Description: Whether resources have been allocated for the device. ,
Required: False ,
}
boolean ,
simulated:
{
Description: Whether the device is simulated. ,
Required: False ,
}
boolean ,
organizations:
{
Description: List of organization IDs that the device is a part of, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_Create (new)
Description :  Create a new device.
Reference :  Link ¶

⚼ Request

PUT:  /devices/{deviceId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
body:
{
Description: Device body. ,
Required: True ,
}
{
id:
{
Description: Unique ID of the device. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device. ,
Required: False ,
}
string ,
template:
{
Description: The device template definition for the device. ,
Required: False ,
}
string ,
enabled:
{
Description: Whether the device connection to IoT Central has been enabled. ,
Required: False ,
}
boolean ,
provisioned:
{
Description: Whether resources have been allocated for the device. ,
Required: False ,
}
boolean ,
simulated:
{
Description: Whether the device is simulated. ,
Required: False ,
}
boolean ,
organizations:
{
Description: List of organization IDs that the device is a part of, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}
,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the device. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device. ,
Required: False ,
}
string ,
template:
{
Description: The device template definition for the device. ,
Required: False ,
}
string ,
enabled:
{
Description: Whether the device connection to IoT Central has been enabled. ,
Required: False ,
}
boolean ,
provisioned:
{
Description: Whether resources have been allocated for the device. ,
Required: False ,
}
boolean ,
simulated:
{
Description: Whether the device is simulated. ,
Required: False ,
}
boolean ,
organizations:
{
Description: List of organization IDs that the device is a part of, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_Update (new)
Description :  Update an existing device by ID.
Reference :  Link ¶

⚼ Request

PATCH:  /devices/{deviceId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
body:
{
Description: Device patch body. ,
Required: True ,
}
object ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the device. ,
Required: False ,
}
string ,
etag:
{
Description: ETag used to prevent conflict in device updates. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the device. ,
Required: False ,
}
string ,
template:
{
Description: The device template definition for the device. ,
Required: False ,
}
string ,
enabled:
{
Description: Whether the device connection to IoT Central has been enabled. ,
Required: False ,
}
boolean ,
provisioned:
{
Description: Whether resources have been allocated for the device. ,
Required: False ,
}
boolean ,
simulated:
{
Description: Whether the device is simulated. ,
Required: False ,
}
boolean ,
organizations:
{
Description: List of organization IDs that the device is a part of, only one organization support today, multiple organizations will be supported soon. ,
Required: False ,
}
[
string ,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_Remove (new)
Description :  Delete an existing device by device ID.
Reference :  Link ¶

⚼ Request

DELETE:  /devices/{deviceId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetAttestation (new)
Description :  Get device attestation
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/attestation
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
type:
{
Description: Type of the attestation. ,
Required: True ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_CreateAttestation (new)
Description :  Create an individual device attestation
Reference :  Link ¶

⚼ Request

PUT:  /devices/{deviceId}/attestation
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
body:
{
Description: Individual device attestation body. ,
Required: True ,
}
{
type:
{
Description: Type of the attestation. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
type:
{
Description: Type of the attestation. ,
Required: True ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_UpdateAttestation (new)
Description :  Update an individual device attestation via patch
Reference :  Link ¶

⚼ Request

PATCH:  /devices/{deviceId}/attestation
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
body:
{
Description: Individual device attestation patch body. ,
Required: True ,
}
object ,
}

⚐ Response (200)

{
type:
{
Description: Type of the attestation. ,
Required: True ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_RemoveAttestation (new)
Description :  Remove an individual device attestation
Reference :  Link ¶

⚼ Request

DELETE:  /devices/{deviceId}/attestation
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetCommandHistory (new)
Description :  Get device command history
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of device command executions. ,
Required: True ,
}
[
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of device command executions. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_RunCommand (new)
Description :  Run a command on a device.
Reference :  Link ¶

⚼ Request

POST:  /devices/{deviceId}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
body:
{
Description: Device command body. ,
Required: True ,
}
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
}

⚐ Response (201)

{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_ListComponents (new)
Description :  List the components present in a device
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/components
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of entities. ,
Required: True ,
}
[
object ,
]
,
nextLink:
{
Description: URL to get the next page of entities. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetComponentCommandHistory (new)
Description :  Get component command history
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/components/{componentName}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of device command executions. ,
Required: True ,
}
[
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of device command executions. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_RunComponentCommand (new)
Description :  Run a command on a component.
Reference :  Link ¶

⚼ Request

POST:  /devices/{deviceId}/components/{componentName}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
body:
{
Description: Device command body. ,
Required: True ,
}
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
}

⚐ Response (201)

{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetComponentProperties (new)
Description :  Get device properties for a specific component
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/components/{componentName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_ReplaceComponentProperties (new)
Description :  Replace device properties for a specific component
Reference :  Link ¶

⚼ Request

PUT:  /devices/{deviceId}/components/{componentName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
body:
{
Description: Device properties. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_UpdateComponentProperties (new)
Description :  Update device properties for a specific component via patch
Reference :  Link ¶

⚼ Request

PATCH:  /devices/{deviceId}/components/{componentName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
body:
{
Description: Device properties patch. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetComponentTelemetryValue (new)
Description :  Get the last telemetry value from a component.
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/components/{componentName}/telemetry/{telemetryName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
telemetryName:
{
Description: Name of this device telemetry. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The last known value of this device telemetry. ,
Required: False ,
}
string ,
timestamp:
{
Description: String-formatted date representing the time when the telemetry value was sent. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetCredentials (new)
Description :  Get device credentials
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/credentials
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
idScope:
{
Description: ID scope for connecting to the IoT Central application. ,
Required: True ,
}
string ,
symmetricKey:
{
Description: The symmetric key credentials for the device. ,
Required: False ,
}
{
primaryKey:
{
Description: The primary key for this credential. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: The secondary key for this credential. ,
Required: True ,
}
string ,
}
,
x509:
{
Description: The X.509 credential information for the device. ,
Required: False ,
}
{
clientCertificates:
{
Description: The X.509 client certificates for this credential. ,
Required: False ,
}
{
primary:
{
Description: The primary X.509 certificate for this credential. ,
Required: True ,
}
{
certificate:
{
Description: The string representation of this certificate. ,
Required: False ,
}
string ,
info:
{
Description: Information about this certificate. ,
Required: False ,
}
{
sha1Thumbprint:
{
Description: The SHA-1 hash value of the certificate. ,
Required: True ,
}
string ,
}
,
}
,
secondary:
{
Description: The secondary X.509 certificate for this credential. ,
Required: False ,
}
{
certificate:
{
Description: The string representation of this certificate. ,
Required: False ,
}
string ,
info:
{
Description: Information about this certificate. ,
Required: False ,
}
{
sha1Thumbprint:
{
Description: The SHA-1 hash value of the certificate. ,
Required: True ,
}
string ,
}
,
}
,
}
,
}
,
tpm:
{
Description: The TPM credentials for the device. ,
Required: False ,
}
{
endorsementKey:
{
Description: The TPM endorsement key for this credential. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_ListModules (new)
Description :  List the modules present in a device
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of entities. ,
Required: True ,
}
[
object ,
]
,
nextLink:
{
Description: URL to get the next page of entities. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetModuleCommandHistory (new)
Description :  Get module command history
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules/{moduleName}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of device command executions. ,
Required: True ,
}
[
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of device command executions. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_RunModuleCommand (new)
Description :  Run a command on a module.
Reference :  Link ¶

⚼ Request

POST:  /devices/{deviceId}/modules/{moduleName}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
body:
{
Description: Device command body. ,
Required: True ,
}
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
}

⚐ Response (201)

{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_ListModuleComponents (new)
Description :  List the components present in a module
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules/{moduleName}/components
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of entities. ,
Required: True ,
}
[
object ,
]
,
nextLink:
{
Description: URL to get the next page of entities. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetModuleComponentCommandHistory (new)
Description :  Get module component command history
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules/{moduleName}/components/{componentName}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of device command executions. ,
Required: True ,
}
[
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of device command executions. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_RunModuleComponentCommand (new)
Description :  Run a command on a module.
Reference :  Link ¶

⚼ Request

POST:  /devices/{deviceId}/modules/{moduleName}/components/{componentName}/commands/{commandName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
commandName:
{
Description: Name of this device command. ,
Required: True ,
}
string ,
body:
{
Description: Device command body. ,
Required: True ,
}
{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}
,
}

⚐ Response (201)

{
id:
{
Description: The request ID of the device command execution. ,
Required: False ,
}
string ,
connectionTimeout:
{
Description: Connection timeout in seconds to wait for a disconnected device to come online. Defaults to 0 seconds. ,
Required: False ,
}
integer ,
responseTimeout:
{
Description: Response timeout in seconds to wait for a command completion on a device. Defaults to 30 seconds. ,
Required: False ,
}
integer ,
request:
{
Description: The payload for the device command, support any primitive types or object. ,
Required: False ,
}
string ,
response:
{
Description: The payload of the device command response, support any primitive types or object. ,
Required: False ,
}
string ,
responseCode:
{
Description: The status code of the device command response. ,
Required: False ,
}
integer ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetModuleComponentProperties (new)
Description :  Get module properties for a specific component
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules/{moduleName}/components/{componentName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_ReplaceModuleComponentProperties (new)
Description :  Replace module properties for a specific component
Reference :  Link ¶

⚼ Request

PUT:  /devices/{deviceId}/modules/{moduleName}/components/{componentName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
body:
{
Description: Module properties. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_UpdateModuleComponentProperties (new)
Description :  Update module properties for a specific component via patch
Reference :  Link ¶

⚼ Request

PATCH:  /devices/{deviceId}/modules/{moduleName}/components/{componentName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
body:
{
Description: Module properties patch. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetModuleComponentTelemetryValue (new)
Description :  Get the last telemetry value from a module component.
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules/{moduleName}/components/{componentName}/telemetry/{telemetryName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
componentName:
{
Description: Name of the device component. ,
Required: True ,
}
string ,
telemetryName:
{
Description: Name of this device telemetry. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The last known value of this device telemetry. ,
Required: False ,
}
string ,
timestamp:
{
Description: String-formatted date representing the time when the telemetry value was sent. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetModuleProperties (new)
Description :  Get all property values of a module.
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules/{moduleName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_ReplaceModuleProperties (new)
Description :  Replace all property values of a module.
Reference :  Link ¶

⚼ Request

PUT:  /devices/{deviceId}/modules/{moduleName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
body:
{
Description: Module properties. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_UpdateModuleProperties (new)
Description :  Update property values of a module.
Reference :  Link ¶

⚼ Request

PATCH:  /devices/{deviceId}/modules/{moduleName}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
body:
{
Description: Module properties patch. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetModuleTelemetryValue (new)
Description :  Get the last telemetry value from a module.
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/modules/{moduleName}/telemetry/{telemetryName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
moduleName:
{
Description: Name of the device module. ,
Required: True ,
}
string ,
telemetryName:
{
Description: Name of this device telemetry. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The last known value of this device telemetry. ,
Required: False ,
}
string ,
timestamp:
{
Description: String-formatted date representing the time when the telemetry value was sent. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetProperties (new)
Description :  Get all property values of a device by device ID.
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_ReplaceProperties (new)
Description :  Replace all property values of a device by device ID.
Reference :  Link ¶

⚼ Request

PUT:  /devices/{deviceId}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
body:
{
Description: Device properties. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_UpdateProperties (new)
Description :  Update property values of a device by device ID.
Reference :  Link ¶

⚼ Request

PATCH:  /devices/{deviceId}/properties
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
body:
{
Description: Device properties patch. ,
Required: True ,
}
object ,
}

⚐ Response (202)

{
$schema:
{
Description: Property values associated with the device. ,
}
object ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Devices_GetTelemetryValue (new)
Description :  Get the last telemetry value from a device.
Reference :  Link ¶

⚼ Request

GET:  /devices/{deviceId}/telemetry/{telemetryName}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
deviceId:
{
Description: Unique ID of the device. ,
Required: True ,
}
string ,
telemetryName:
{
Description: Name of this device telemetry. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The last known value of this device telemetry. ,
Required: False ,
}
string ,
timestamp:
{
Description: String-formatted date representing the time when the telemetry value was sent. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
FileUploads_Get (new)
Description :  Get the file upload storage account configuration.
Reference :  Link ¶

⚼ Request

GET:  /fileUploads
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
account:
{
Description: The storage account name where to upload the file to ,
Required: False ,
}
string ,
connectionString:
{
Description: The connection string used to configure the storage account ,
Required: True ,
}
string ,
container:
{
Description: The name of the container inside the storage account ,
Required: True ,
}
string ,
sasTtl:
{
Description: ISO 8601 duration standard, The amount of time the device’s request to upload a file is valid before it expires. ,
Required: False ,
}
string ,
state:
{
Description: The state of the file upload configuration ,
Enum:
{
pending: No description available. ,
updating: No description available. ,
deleting: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
}
,
Required: False ,
}
enum ,
etag:
{
Description: ETag used to prevent conflict with multiple uploads ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
FileUploads_Create (new)
Description :  Create the file upload storage account configuration.
Reference :  Link ¶

⚼ Request

PUT:  /fileUploads
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
body:
{
Description: File upload storage account configuration body. ,
Required: True ,
}
{
account:
{
Description: The storage account name where to upload the file to ,
Required: False ,
}
string ,
connectionString:
{
Description: The connection string used to configure the storage account ,
Required: True ,
}
string ,
container:
{
Description: The name of the container inside the storage account ,
Required: True ,
}
string ,
sasTtl:
{
Description: ISO 8601 duration standard, The amount of time the device’s request to upload a file is valid before it expires. ,
Required: False ,
}
string ,
state:
{
Description: The state of the file upload configuration ,
Enum:
{
pending: No description available. ,
updating: No description available. ,
deleting: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
}
,
Required: False ,
}
enum ,
etag:
{
Description: ETag used to prevent conflict with multiple uploads ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
account:
{
Description: The storage account name where to upload the file to ,
Required: False ,
}
string ,
connectionString:
{
Description: The connection string used to configure the storage account ,
Required: True ,
}
string ,
container:
{
Description: The name of the container inside the storage account ,
Required: True ,
}
string ,
sasTtl:
{
Description: ISO 8601 duration standard, The amount of time the device’s request to upload a file is valid before it expires. ,
Required: False ,
}
string ,
state:
{
Description: The state of the file upload configuration ,
Enum:
{
pending: No description available. ,
updating: No description available. ,
deleting: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
}
,
Required: False ,
}
enum ,
etag:
{
Description: ETag used to prevent conflict with multiple uploads ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
FileUploads_Update (new)
Description :  Update the file upload storage account configuration
Reference :  Link ¶

⚼ Request

PATCH:  /fileUploads
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
body:
{
Description: File upload storage account configuration body. ,
Required: True ,
}
object ,
}

⚐ Response (200)

{
account:
{
Description: The storage account name where to upload the file to ,
Required: False ,
}
string ,
connectionString:
{
Description: The connection string used to configure the storage account ,
Required: True ,
}
string ,
container:
{
Description: The name of the container inside the storage account ,
Required: True ,
}
string ,
sasTtl:
{
Description: ISO 8601 duration standard, The amount of time the device’s request to upload a file is valid before it expires. ,
Required: False ,
}
string ,
state:
{
Description: The state of the file upload configuration ,
Enum:
{
pending: No description available. ,
updating: No description available. ,
deleting: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
}
,
Required: False ,
}
enum ,
etag:
{
Description: ETag used to prevent conflict with multiple uploads ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
FileUploads_Remove (new)
Description :  Delete the file upload storage configuration.
Reference :  Link ¶

⚼ Request

DELETE:  /fileUploads
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Organizations_List (new)
Description :  Get the list of organizations the user has access to in an application
Reference :  Link ¶

⚼ Request

GET:  /organizations
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of organizations. ,
Required: True ,
}
[
{
id:
{
Description: Unique ID of the organization. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the organization. ,
Required: False ,
}
string ,
parent:
{
Description: ID of the parent of the organization. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of organizations. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Organizations_Get (new)
Description :  Get an organization by ID
Reference :  Link ¶

⚼ Request

GET:  /organizations/{organizationId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
organizationId:
{
Description: Unique ID of the organization. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the organization. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the organization. ,
Required: False ,
}
string ,
parent:
{
Description: ID of the parent of the organization. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Organizations_Create (new)
Description :  Create an organization in the application
Reference :  Link ¶

⚼ Request

PUT:  /organizations/{organizationId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
organizationId:
{
Description: Unique ID of the organization. ,
Required: True ,
}
string ,
body:
{
Description: Organization body. ,
Required: True ,
}
{
id:
{
Description: Unique ID of the organization. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the organization. ,
Required: False ,
}
string ,
parent:
{
Description: ID of the parent of the organization. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the organization. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the organization. ,
Required: False ,
}
string ,
parent:
{
Description: ID of the parent of the organization. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Organizations_Update (new)
Description :  Update an organization in the application via patch
Reference :  Link ¶

⚼ Request

PATCH:  /organizations/{organizationId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
organizationId:
{
Description: Unique ID of the organization. ,
Required: True ,
}
string ,
body:
{
Description: Organization patch body. ,
Required: True ,
}
object ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the organization. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the organization. ,
Required: False ,
}
string ,
parent:
{
Description: ID of the parent of the organization. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Organizations_Remove (new)
Description :  Delete an organization
Reference :  Link ¶

⚼ Request

DELETE:  /organizations/{organizationId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
organizationId:
{
Description: Unique ID of the organization. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Roles_List (new)
Description :  Get the list of roles in an application.
Reference :  Link ¶

⚼ Request

GET:  /roles
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of roles. ,
Required: True ,
}
[
{
id:
{
Description: Unique ID of the role. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the role. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of roles. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Roles_Get (new)
Description :  Get a role by ID.
Reference :  Link ¶

⚼ Request

GET:  /roles/{roleId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
roleId:
{
Description: Unique ID for the role. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the role. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of the role. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Users_List (new)
Description :  Get the list of users in an application
Reference :  Link ¶

⚼ Request

GET:  /users
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The collection of users. ,
Required: True ,
}
[
{
id:
{
Description: Unique ID of the user. ,
Required: False ,
}
string ,
type:
{
Description: Type of the user. ,
Required: True ,
}
string ,
}
,
]
,
nextLink:
{
Description: URL to get the next page of users. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Users_Get (new)
Description :  Get a user by ID
Reference :  Link ¶

⚼ Request

GET:  /users/{userId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
userId:
{
Description: Unique ID of the user. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the user. ,
Required: False ,
}
string ,
type:
{
Description: Type of the user. ,
Required: True ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Users_Create (new)
Description :  Create a user in the application
Reference :  Link ¶

⚼ Request

PUT:  /users/{userId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
userId:
{
Description: Unique ID of the user. ,
Required: True ,
}
string ,
body:
{
Description: User body. ,
Required: True ,
}
{
id:
{
Description: Unique ID of the user. ,
Required: False ,
}
string ,
type:
{
Description: Type of the user. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the user. ,
Required: False ,
}
string ,
type:
{
Description: Type of the user. ,
Required: True ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Users_Update (new)
Description :  Update a user in the application via patch
Reference :  Link ¶

⚼ Request

PATCH:  /users/{userId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
userId:
{
Description: Unique ID of the user. ,
Required: True ,
}
string ,
body:
{
Description: User patch body. ,
Required: True ,
}
object ,
}

⚐ Response (200)

{
id:
{
Description: Unique ID of the user. ,
Required: False ,
}
string ,
type:
{
Description: Type of the user. ,
Required: True ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}
Users_Remove (new)
Description :  Delete a user
Reference :  Link ¶

⚼ Request

DELETE:  /users/{userId}
{
api-version:
{
Description: The version of the API being called. ,
Required: True ,
}
string ,
userId:
{
Description: Unique ID of the user. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: Error code for specific error that occurred. ,
}
string ,
}
,
$schema:
{
Description: The response error definition ,
}
{
error:
{
Description: Error details for current request. ,
Required: True ,
}
{
code:
{
Description: Error code. ,
Required: True ,
}
string ,
message:
{
Description: Error message details. ,
Required: True ,
}
string ,
requestId:
{
Description: Correlation Id for current request. ,
Required: False ,
}
string ,
time:
{
Description: The time that error request failed. ,
Format: date-time-rfc1123 ,
Required: False ,
}
string ,
}
,
}
,
}